入门
快速搭建 Rust 开发环境并编写一个小应用!
安装 Rust
你可以在 Rust Playground 在线尝试 Rust,无需在你的电脑上安装任何东西。
无需安装即可尝试 RustRustup:Rust 安装器和版本管理工具
安装 Rust 的主要方式是使用一个叫做 Rustup 的工具,它是一个 Rust 安装器和版本管理工具。
看起来你正在运行 macOS、Linux 或其他类 Unix 操作系统。要在终端中下载并安装 Rustup,请运行以下命令,然后按照屏幕上的指示进行操作。如果你使用 Windows,请参见 "其他安装方法"。
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
看起来你正在运行 Windows。要开始使用 Rust,请下载安装程序,然后运行程序并按照屏幕上的指示进行操作。你可能需要根据提示安装 Visual Studio C++ Build tools。如果你不使用 Windows,请参见 "其他安装方法"。
Linux 的 Windows 子系统
如果你是 Linux 的 Windows 子系统用户,请在终端中运行以下命令,然后按照屏幕上的指示安装 Rust。
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
要安装 Rust,如果你正在运行 Unix 系统,例如 WSL、Linux 或 macOS,
在终端中运行以下命令,然后按照屏幕上的指示进行操作。
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
如果你正在运行 Windows,
下载并运行 rustup‑init.exe,然后按照屏幕上的指示进行操作。
Rust 是最新的吗?
Rust 更新非常频繁。如果你是很久以前安装的 Rustup,你的 Rust 版本很可能已过时。通过运行 rustup update
获取最新版本的 Rust。
了解更多关于安装的信息
Cargo:Rust 构建工具和包管理器
安装 Rustup 后,你也会获得最新稳定版本的 Rust 构建工具和包管理器,也就是 Cargo。Cargo 可以做很多事情:
- 使用
cargo build
构建你的项目 - 使用
cargo run
运行你的项目 - 使用
cargo test
测试你的项目 - 使用
cargo doc
为你的项目构建文档 - 使用
cargo publish
将库发布到 crates.io
为了测试你是否安装了 Rust 和 Cargo,你可以在你选择的终端中运行这个命令:
cargo --version
其他工具
许多编辑器都提供了 Rust 支持
生成新项目
让我们用新的 Rust 开发环境编写一个小应用。首先,我们将使用 Cargo 为我们创建一个新项目。在你选择的终端中运行:
cargo new hello-rust
这将生成一个名为 hello-rust
的新目录,其中包含以下文件:
hello-rust
|- Cargo.toml
|- src
|- main.rs
Cargo.toml
是 Rust 的清单文件。你可以在其中存放项目的元数据以及依赖项。
src/main.rs
是我们编写应用程序代码的地方。
cargo new
步骤为我们生成了一个“Hello, world!”项目!我们可以进入创建的新目录并在终端中运行以下命令来运行这个程序:
cargo run
你应该在终端中看到:
$ cargo run
Compiling hello-rust v0.1.0 (/Users/ag_dubs/rust/hello-rust)
Finished dev [unoptimized + debuginfo] target(s) in 1.34s
Running `target/debug/hello-rust`
Hello, world!
添加依赖项
让我们为应用添加一个依赖项。你可以在 crates.io(Rust 的包注册中心)上找到各种各样的库。在 Rust 中,我们通常将包称为“crate”。
在这个项目中,我们将使用一个名为 ferris-says
的 crate。
在我们的 Cargo.toml
文件中,我们将添加这些信息(这些信息来自 crate 页面):
[dependencies]
ferris-says = "0.3.1"
我们也可以通过运行 cargo add ferris-says
来完成此操作。
现在我们可以运行:
cargo build
……然后 Cargo 将为我们安装依赖项。
你会看到运行此命令为我们创建了一个新文件 Cargo.lock
。该文件记录了我们在本地使用的依赖项的确切版本。
要使用此依赖项,我们可以打开 main.rs
,删除其中的所有内容(那只是另一个示例),并添加这一行:
use ferris_says::say;
这一行表示我们现在可以使用 ferris-says
crate 为我们导出的 say
函数了。
一个小型 Rust 应用
现在让我们用新的依赖项编写一个小应用。在我们的 main.rs
中,添加以下代码:
use ferris_says::say; // from the previous step
use std::io::{stdout, BufWriter};
fn main() {
let stdout = stdout();
let message = String::from("Hello fellow Rustaceans!");
let width = message.chars().count();
let mut writer = BufWriter::new(stdout.lock());
say(&message, width, &mut writer).unwrap();
}
保存后,我们可以通过输入以下命令来运行我们的应用:
cargo run
如果一切顺利,你应该会看到你的应用在屏幕上打印出:
__________________________
< Hello fellow Rustaceans! >
--------------------------
\
\
_~^~^~_
\) / o o \ (/
'_ - _'
/ '-----' \
这只螃蟹是谁,Ferris?
Ferris 是 Rust 社区的非官方吉祥物。许多 Rust 程序员称自己为“Rustacean”,这是对词语“甲壳动物 (crustacean)”的戏称。我们称呼 Ferris 时可以使用任何代词,“她”、“他”、“他们”、“它”等等。
Ferris 这个名字取自形容词“ferrous”,意为“含铁的”或“与铁有关的”。由于 Rust (生锈) 通常形成于铁上,这似乎是我们吉祥物名字的一个有趣的来源!
你可以在 rustacean.net 上找到更多 Ferris 的图片。